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CHAPTER 1 



AN INTRODUCTION TO RAP4 



'I \ 



WHAT IS RAP4? 



RAP4 is a complete sound sampling* playback, editing and sequencer 
package for the Commodore Plus/4 compute^. "Sampling" is the process 
by which any sound may be converted tb a format understandable by 
computer, namely a set of numbers. In this form., the sound may be 



played back at different speeds., altered,, reversed, played like a 
musical instrument, or sequenced into a] melody, RAP4 provides all 
these features and includes many wh|ich until now have only been 
available on far more powerful 16-bit computers., 



RAP 4 is unique in several respects.! Firstly,, at the time of 

writing, it is the only commercial sound; synthesis package available 

for the Plus/4 computer, and secondly, | it uses a WIMP graphical 

control interface of the type foundj on such computers as the 

Commodore Amiga™ and Atari ST™. Instead of using commands and 
complex keystrokes, RAP4 uses just the cursor keys, a joystick, or a 
mouse for all its functions. Every function of RAP4 is operated in a 
consistent manner so that within a fe«N minutes the user should be 
able to control every single feature tb the full. Although RAP4 
incorporates some powerful operations, ; the simplicity of use makes 
the program fun to use* 



LOADING THE RAP4 EDITOR 



The RAP4 package consists of two programs contained on a single 
5.25" disk - the "Editor 11 and "RAP4 j BASIC" '. The Editor is where 
sampling is performed and where all of the work goes on, RAP4 BASIC' 
allows you to use sounds and melodies in; your own BASIC programs. To 
load either of the programs, simply switch on your computer, insert 

the RAP 4 disk in your disk drive and pre&s <SHIFT>~<RUN/3T0P>. After 

a few seconds, a menu will appear with two options. To load the 

i 

Editor, simply press key ,l 1 " , or to load RAP4 BASIC, press key "2 , ' a 

I 

On pressing a key, the menu option will ! flash, the disk-drive will 
whirr again, and your chosen prograrjn wil be loaded and run 
automatically. I 






CHAPTER 2 



STARTING TO USE THE RAP4 EDITOR 



i. ►■ 



THE RAP4 MAIN SCREEN 



When 



! 



screen 



you have 
will 



disk menu, the 



disp lay 



phrases 



copyright message, 

t he t od line of t he 

of RAP4- 



run the RAP4 Editor program from the 

a grey desktop with 
arrow-shaped pointer and row of 
screen. There ar^ two 
the pointer and menu bar 

keyboard, joystick in port 2L or mouse- Keyboard control 
is by the cursor-key cluster at the bottom-right of your Plus/4, 
using the <RETURN> key instead of the joystick fire-button. If you 



on tne top 
important elements to the control 
» There are three methods of control linq the 



pointer- 



wish to use a mouse, any mouse which can 
used. These include Date! Electronics" 



emulate a joystick 



be 



mouse 

whole of 



may 
and Commodore's 1351 



mouse. The pointer can be moved around tne 

will adapt '.to the different graphics underneath it 



the screen and 



or fire-button is used for selecting choices or options 



The < RETURN > key 



RAP4 

has 



is organised as a number of individual screens, each of which 
a specific purpose. All of these screens are accessed using the 



menu-bar" at the head of the main scree 
the titles in the menu-bar (move onto th 
the fire-button) a menu will droD dow 

To select one, 

select button 



or 



highlighted 



then push your 

option. From the main screen, 

RAP4 J, s other screens. When 



drop 
just use Up 
. To leave t 



e menu, 
each menu bption is 



. When you click on one of 

t option and press < RETURN > 

with several options, one 

nd Down to highlight it and 

select the "Exit" 



the name of one of 

the menu 



bar 






is 
other purpose. 



ep laced by 



you are using another screen, 
the title of the Current screen and serves no 



THE POINTER SPEED SETUP SCREEN 



on 



The Pointer Speed screen 
the SYSTEM menu- When 



is opened by selecting the 3PLLD option 

reen will 



V o u 



clear, a title bar will be shown at 
several objects will appear on the screeifi. 



select this option, the 

thi top of the 



ri l 






\ 



creen, and 



At the 



of the 



"Window" 



This 



top ot- tne screen is a 
rectangular box which displays information on-screen 

the window shows the current speed setting of pointer 



is simply a 
On the Pointer- 



screen, 

* 

m o v em e n t a s a b a r - g r a p h 
movement . 



the longer 



t h e b a r 



the 



faster the 



Below the window a.re three "Buttons",, Buttons are used throughout 

There are several 



RAP4 as the means of actually performing | act ions 



types 



i 



o f 



buttons 



z> » 



7 h e 



H i~i 



Redefine" an«: 



a 
It 



i "Quit" buttons are simple? 



action buttons. If you click on this typi of button. 



immediately be carried out. 



•i 






wJ 



an action will 



b u 1 1 o n i s d i v i d e d 



sections and is a setup button- 



peed" 

/ou carb select either 
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The Pointer Speed Setup Screen (Cant..) 



movement 



Note that the actual speed of 

will a row and diminish* 



* 4 v , ■ 



w ill n o t c h a n g e , b u t t h e 
bar-graph will grow and diminish. When you are happy with the 
setting, click on "Redefine" to set up the change. Try out the new 
speed and adjust it to your preferred value. You can then click on 
the "Quit" button to return to the main 



summarized in the Command Summary shown 



windows and buttons on each screen 



a 



menu. These 

below. 



operations are 
This lists the 



ong with the location 






vertical and horizontal positions and the object's function 



Window 



Location 



Funk 



tion 



Poi nter Speed 



Top-Centre 



Shows pointer movement speed 



Button 



- Speed 
Redef i ne 
Quit 



Centre-Left 

Centre Centre 

Centre-Right 



■+■ / -■• 



pointer speed 
Locks in change to 
Returns to main scr 



sp 

sen 



eed 



Command summaries of this type provi 
screen's functions. Throughout this manu 
summary for each screen and instead 
brief description of each of the screen 
1 ayout shou Id a 1 1 ow vou to 1 ear n 




a 



a concise breakdown of 

will find a command 



y o u 

confidently., and also keeps the manual 
which has kept the price of RAP4 low 
descriptions have been kept short, 
f u n c t i o n s a r e c o m p 1 e t e 1 y d o c u m e n t e d 



e 

1 you 

of longhand &xp lariat ions, a 

s functions and uses. This 
t q u s e R A P 4 a u i c k 1 v a n d 



q u i c k 1 y 
concise., one of the aspects 
Where functions are obvious, 



b u t 



be 



iixrs that t he c omp 1 e % 



/ 
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CHAPTER 3 



CREATING A SAMPL E 









,- »: 



itw^.l 



11 : . 



£ ■ 



►v%r; 



THE SETUP SAMPLE DATA SCREEN 



The Samp Is 



*4 



Dat 



EDITOR menu. Its 



a screen is 
c o m mand s u m m a r y 



**■/ **#* **"•*■ ***» **»■ 



Cl L. U ta? ^J 

is as fd 



Window 



Location 



i ng the SETUP' op t i o n of t he 
1 lows- 



Function 



"Use With Care" 
Sample Selection 
Samp I e I nf or mat ion 



Top -Left 
Top -Right 

Centre-Left 



Showls warning to take care 
Selection of current sample 
Shows sample information 



Button 






Location 



Function 



Start 

End ■- 
Name 

Hi./Lo <- 
Redefine 
Quit 



Bottom'-Left 

Bottom-Left 
Bottom-Right 
Bottom-Right 
Bottom-Left 

Bottom-Left 



+•/ 



Entr 



sample start addres 
sample end address 



y of sample names 
Alteration of high/low byte 

s in current settings 
rns to main screen 



Lock 



Retu 



The Sample Data screen 

to 



is 
them., 



recording 

at a time 



pr i or 

stored in memory ***. « ^*,«w, 
screen should he used with car 
so a graphic warning window is 

screen is the Sample 

of RAP4 ? s screens. This w i now is 



used to set u 
RAP4 allows 
sharing the 



6 



V*#, Wt> 



a as you 

displayed 

Selection window w 



T o c h 
nulber 



tjwist' 



n u m b e r 



1 1 






p information about samples 

up to eight samples to be 

4k RAM of the Plus/4. This 

nnot undo t 



In 



hanges you make, 

of the 



* 

% 



the top— right 
hich is found on almost all 



-,-A J i U 



that 






samp 1 e 



:lick on the sample name or 




show the start 



end 



o c c u p y . 
"<-" and " 



w i 1 1 
is show I 
of this 



h i q h 1 i q ht - 



:i, n 



f 1*4* -or- 



a combination of window and button 
a s a m p 1 e * 
in the window-, 
information about the current sample 
Information window. NAME shows the name 

and 
sample will occupy. You can change 
appropriate 

to the valid address range. The 
which selects whether the addresses are 
in steps of 1 (LOW) or 256 (HI). To toggl 

the '■'<- — >" section- The NAME button opente a new window displaying a 
prompt and flashing "I -Bar" cursor. You 
<DEL> to delete, and enter it by pushing 



i in the Sample 

sample. START and 

addressed of the area of memory the 

the addresses using the 

" buttons., and you are automatically limited 

High/Low button is a toggle-button 

incremented and decremented 
bet ween t hese - c 1 i c k on 




When vou 
attr i botes 



have made any alterations you want 
c 1 i c k o n t h e R E D E F I N E button to 1 o c k 



can repeat this for each 



S W 



amp 1 



can type 
< RETURN >. 



a new 



name 



use 



I**-* 



to the current sample 

i n t h e c h anges. Y o u 

a n d c lit k o n U I T t o r e t u r n to the 



main screen 



THE AUDIO MONITOR SCREEN 



***** 

r o r 
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The Audio Monitor Screen (Cant..) 



When you 



y o u 
and 



h 



have a suitable sound 
ave not recorded a sound) j, 
enter the Audio Monitor- 



on t 



pe (use a music cassette if- 
place thfe cassette in your Datasette 




screen. 



selecting the MONITOR option on the SAMPLER menu. 



7 



The screen is opened by 



Window 



Location 



Function 



Audio Level 



Top "--Left 



D i s p 1 a y s 1 e v el o f a u d i o i n p u t 



Button 



Location 



Function 



Monitor 

Quit 



Top-Left 
Top -Cent re 



Activates the audio monitor 
Returns to main screen 



The Monitor screen is used to 
place for , sample recording- 
place, click on the MONITOR 

Datasette- 



position your tape at the right 
In order to move the tape to the right 



button 



The pointer will disappear an 
is relayed through your Plus/4 to your t 
up the volume to make sure you ca 
displayed in the Audio Input window as a 
and <F.Fwd> buttons on your Datasette 
push <STOP> and the pointer will ' re-app 
reset or make a note of the counter 



and 



<PLAY> 



press <.klhy> on your 
the audio on your cassette 
levision or monitor - turn 

The audio is also 
Use the <Rewind> 



that you izan easily relocate the sound, 
position., click on QUIT to return to the 



hear iti 
bar graph, 
to position your tape, then 

ar on-screen. If you like, 
sad ing on your Datasette so 
ifJhen you are happy with the 
main screen. 




THE SOUND SAMPLER SCREEN 



The Sound Sampler screen is the hea 
used for actually recording and playin 
s c r e e n s c o m m a si d s u m m a r y i s s h o w n h e r a « 



-t of the RAP4 system and 
-back sampled sounds. 



is 
The 



Window 




ion 



Function 



Record Speed 
Play Speed 
Sample Select:!. o n 
Sample Location 



T o p •" Left 
Top -Left 
Top -Right 
Centre-Left 



I.- r! 



Sho 



speed 



S hoiks samp 1 e r ec o r a i ng 

b sample p 1 ay bac k speed 
Selection of current sample 
Shows the sample's memory area 



Button 




ion 



Function 



Record -/+ 
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Sample recording speed 
Samp 1 e pi ay bac k speed 
ivates recording of sample 
Lvates playback of sample 



' 1 "S 



Locks in changes to speeds 
Returns to main screen 
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The Sound Sampler Screen (Cont.-) 

If you use a very high speed, the quality of the sample recorded 
will be very high but the sample will consume memory very quickly. 
If you use a slower speed, the sound quality may suffer., but the 
sound will not need as much memory. You should experiment and select 
a recording speed to suit individual sounds., When you play the? 
sample hack., you will normally use the same speed as that used for 
recording it, but you can if you wish change the playback speed to 
produce effects such as decreasing the pitch of an instrument sample 

a recorded voice sound comic and squeaky, by increasing 
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To play back the sample, just click on PLAY and enjoy! To 
the main screen, click on QUIT. 
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SAMPLE ALTERATION & EDITING 



THE REVERSE SAMPLE SCREEN 



The real power of computer sampling 



1 /•*♦ 



■ ■l 144-4 "#4 * 4 *•» * » 

a r i <a w si y 

methods. The 



Which it: 



:a 



j ust i mposs i b 1 e lis i ng 



£• i i- rc: +• i tm k •£■ 



j* f '\ pa or pi £3 -£> •£ pa r • 



t * ^ 



IS 



u sing 






Window 



Location 



the ability to alter sounds 

c o n v e n t i o n a 1 r © c o r d i n g 
"Reverse" 



a n c j 



* t« 






pert or me a 



Function 



Samp le Location 
Samp 1 e Se 1 act ion 



Top "■"Left 

Top -Right 



3 ho 
Sal 




Buttons 



Location 



s samp 1 m memory ar ea 
ction of current sample 



Function 



Rev . 4 Reverse ) 

Play 

Quit 



Centre-Left 
Centre-Left 



Reverses current sample data 
Plays back current sample 



Centre-Centre Returns to main screen 



The Reverse screen has one simple -Fund 
of a sample in memory so that when pi 
screen features the familiar sample sele 
to select the sample to be reversed, the 
three buttons. The REV button revers 
sample. PLAY plays the current sample b 
main screen. To reverse a sample, click 
normal click on REV again. 



to 



the data 



The 



ion - to reverse 
yed it plays backwards. 
tion window which is used 
sample location window, and 
the current highlighted 
and QUIT returns to the 




THE SAMPLE EDITOR SCREEN 



found 



in the RAP 4 
w h i c h 



RE U 



V , 



and to return it to 



jb a c k &Qe is a r q u a b 1 y i t s m o s t 
f o u n d i n v e r y f e w s o u n d 



The Samp 1 e Ed i tor 
powerful feature, and is one wnx en i 
packages for any 9 -fa it computer. The Sample Editor 
by selecting EDITOR from the EDITOR menu. The Command Summary 
fol lows- 



screen x\ 



openea 
is as 



Window 



Location 



Function 



Wavef orm 

Sample Select ion 

E c j i t In f o r m a t i o n 



1 fci»* Hit l vrrf | ■?** 

i i j i i —** j \*+j ■f* t j 

Top -Right 
Cent r e -Rig ht 



ShoD 



4th \w+* \*4+ W *U 4**r I I 



^s samp I e wavef or m 
Se 1 ect i on of cur rent samp 1 e 
Shows edit i ng i nf or mat i on 



Button 



Location 



Function 



t*4ft 



Move 



• *■•■* 



M ft ! }J 



I 4* ft L * 1 * T 



" P ■ »*• »» ^ 






■r 

L 
4*# 



Centre-Left 

P *3 n *{- }••• pa — P cri n +• k* r::i 

I* ibi^ *(** *T** *44* *•#* I *»M 1 *!** 

/'*«! i 1 1 ? Vff} ! !"» T' * 

1 I »■** ftJt r ^Xru lipi f* t#* 1 ,■ ** J t(*i 

»"H ; i • ! •?|»""f ,-* /- ! 



M o v e s e d i t c: u r s cd r 



up /down 



Amp I i t ude of byte 



**!** r "*"" 
1 ^ 












r 



»* 






4*14 .ill 



*r«4 ^»# » ,■*■ f * 4*+t> ■;-** 






i>i» 14- * »** J*w* 



14*4^ f »*4 4 

4 444.4 4»»| ***4 I "| 4*4« ■*■•** 

l ' t ^ffr '•*■ »*■• * i44 ■ I •*** 



., J.. 



hit f ;i 1 



> f 4 9 1 r » 



»T44 ^[ -4**- 1 

1 J t#44 4f4# 4|*4 4>4 4b 4*T* 4 ■ -4 *4»4 {4*4> ^ I** 

I : I J I ! ( 3 ill *"*" '*" : * : • t 

1 4 44 \ * J ■ > ft * 4 P 4 --* r-+ 8 14 4 4 -«i 4441 4 4 4 4 ■ 

* *4> 

#*•♦■ |J 44 4*. 44 

I] **■#* -1*4 *i« 4444 J444t T i ft ■+** 4**4 *l*4 

H : j ! ! j ii ;— ■-: ■- \ j J j 1 

***^ 4»*4 »*4 *4* 44+4/ * ) f * t(,# ^444 ♦ 4 »*4 



j ~ r* 1 






»4 4*4* !*■■ 44^4 4-44 f*t* 4444 4»44 •**# 

[ I 1 I I .444 1 i 1 -V ■! %••* 

V-*4i 4 4 \4IT4 1 * V44JJ *-444> *44** 



.J^ ft I 






♦■**4 p 

i * J 

1 - ■ 4 # 

. 1 5 .■'-, . 



- « -*- 



/ J 



444 V J a4ft« FfW 

■4 M^tt 1 i r*»i 



4*BJ 



!J >4*i. t|*4j f - * --, .,*., .*^ t L ¥ „, 4 i,*.. .44 j *• |*4> 4-** •••-> •,« •»*» .*">■ |*4^ 

\\7*i %44> r r P*4 i p I 4i,J 'ft4# U^ t I I \»,*4 *L J i 4,-4 V**. ^ '»►- '*•«- ^ t 



• I 

111* 

: 1 

*+4* 



The Sample Editor Screen (Cont..) 



As you can see., 
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THE DIGITAL SYNTHESIZER SCREEN 



The Digital 
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The Setup Drumkit Drums Screen (Cont..) 
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The Melody Sequencer Screen (Cont-.) 
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carried out 
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editing of melodies is 
semi-standard musical notation, on a 
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the actual 
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musical staves with key "D" being middle?— C and key "L" being B- 
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window shows 16 notes at a time and t 
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button,, This appe 
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be entered and stored,, 
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drum "IT 
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When 
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CHAPTER 6 



DATA DELETION & STORAGE 



ERASING SAMPLES & MELODIES 
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start afresh 



Two 



THE ERASE SAMPLE DATA SCREEN 
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SAVING YOUR WORK 



THE DATA STORAGE SCREEN 



load and save. RAP 4 data onto 



The Data Storage screen allows you to. 

disk. The screen allows the storage of data for later use 

All 






types of 



data may be 



tape or 

and for import into RAP4 BASIC program* 

saved including samples, synthesizer /tfrumkit setups and melodies. 

RAP4 also features a 

an incredible 2340-baud. The Command 



superlatively fast tjape system which allows the 



saving of data onto tape at 



b u m m a r v 






shown below,, 



Window 




ion 



Func:ti on 



11 [ o & h m a v n pa 1 ?=> 1- e ,. 

""* *"* Hill 1 r -" J ll *Vt«* 1 I **"M 1 l f 1 \ \ 



U 



u :t 



Top- -Left 

T i "i n ■*- J-v 1 1 nhf 



Warns that LOAD mav delete data 






Button 



Location 



*4++ V 



t# 



sample **n 



'fi 4t#4 



If- 



Y#ss 






Function 



Save/Load 
Save /Load 



Samp le 
Synth* 



T o p 



i 



eft 



■~ ■«■*» *<*«** .i 



Save/Load Mplody 

J - 

Disk /Tape 
Di rectory 
ix i t 



C e n t r e •-• L m f t 
Bottom-Left 
Bottom-Right 

Bottom-Left 
Bottom-Right 



setup 



Saves/Loads a sample 
Saves/Loads a synth. /drum 
Saves/Loads a melody- 
Toggles between disk/tape use 
Displays disk director 
Returns to main screen 



r# » 4 



V 



s c r e e n 



In fact* 

second of 



the 



Selection w i n dow 



the Data Storage screen is m^de up of two screens., 
which is called up by the Directory button. The Sample 

used to select which sample to save. When 



is 



aut omat i c a 1 1 y 



1 oad i ng .» samp 1 es 

The DISK/TAPE toggle button is used 

is to be carried out using disk or tape Systems., 



sample to save 
load irito their original position,. 

elect whether data storage 



to s 






I o o b t a i n 



a list a f 



f i 1 e s o n t h e d i s k 



click on the DIRECTORY button, 
window and two button* 



A 



new 



^> » 



large window. To slow down the display 

to halt 



i n v o u r d i s k - d r i v e , y o u c a n 

creen opens with a large 

fhe disk directory will be displayed in the 

old down the Commodore <C~ 



) 



!••: e y „ 



■ 4«+ * 



it, push <CTRL> 






W he n t he d i r^c t o r y Finishes H 

you can repeat it by clicking on the REPEAT button, 
the main Data Storage screen, click on RETURN 



o r 






r e t u r n 






Saving & Loading Data On Disk 



To 



to disk 



s i mp 1 y 



save a sample 
Selection window and click on SAVE Sample} 

" will ap p Bar a n d t he samp 1 e w i 



"Saving, „ „ 



o 









svnthesi zer /drumk it setu 



highlight it in the Sample 
■'A window with the message 
11 be saved,; 



S A V E b u 1 1 o n • A w i n d o w will 







1 



m e 1 o d v 






**4 ♦ r 



appropr iate 

Enter a name for the data and push <RETL 

will appear and the data will be saved* 



Po reload a sample* synthesi^er/drumki 

t h e a p p !■" o p r i a t m L A D 



c 1 i c k o n 



pen 



asking f-or 
The "Saving- . 



on the 
a filename,. 



)■ 



window 



t setup, or melody H just 
buttori, A window wil appear again 



asking you for the filename- Enter a name 



r.-i | prinw w i 1 l ,■ ••■ r- t ,v.v, n rii"»n! ^ v i y"n ''" hp mp»*~^ane 

£ 1 V P*P *■•■ 



■p» 



i *H 



q I *-- 



'V* I 1 I I * " | " I J I ] * V»4 : ? | («-^ \-- V f -> v-i J^ t 4 l.-\} } ? J I I "\ I 1 > j ;**-» t r J 



r, i 






# »■ 



1*14 illl 4 I » » T ♦ * ] * * * *. * * < ■ * » I ■ * ♦ I * * »l 

j J i.. P . * r.-A } ; } ,..x > \u.\ i J 



•f fi=: 



and 



;***- J.«l *p*J 1* | t * j j | j I 



► 4 






n 



to it » 



push < RETURN >. A 

1* f" It /» ■ 'I 

H;^ 1" ;^ ja! 'i 1 1 



II 



■ It I 






1 



*• ?*** 






y ii* tftft 



■V' 



** 



Saving St Loading Data On Disk (Cont.-) 



If while? saving or loading RAP4 data on disk an error occurs, a 
new window will. appear displaying the error message, accompanied by 
a button marked OK. To acknowledge the error and abort the load, 



c 1 i c k a n K 

The 



or QUIT. 
"ILLEGAL 



The error displayed 
FILE TYPE" indicates 



error 

during loading was not a real RAP4 file 
H HM< ERROR. MESSAGE, MNhNN" and these can 

■ # * 

Plus/4 manual - Input /Output errors 
ERROR *NN" and are as for TEDMOIM. 



will be one of three types: 

that the file selected 

shown as 



a r e 



A disk err6r is 
Ibe found on page 176 of your 
shown as "OPER" 



Saving & Loading Data On Tape 



The method for 



RAP4 data 



s 



MG bvb ! bri 



identical as 



saving KHrf aar.a on tape is almost 
that for saving data on disk. Before the "Saving..." window appears 
however, the procedure is as follows: A window will appear telling 
you to "Wind tape and press Stop"* Insert a blank tape in your 
Datasette and position the tape using <F.Fwd> and <Rewind>. When you 
have done this, press <Stop>. The message will change, telling you 



to 



<Record> 



on 
window will 



vour 



Datasette 



press 
"Saving. .. '' window will appear , 
of blue and white stripes, and your data 






When you do this 



the 



the screen will change to a pattern 

will be saved- 



When loading data from tape you do not need to specify a filename 
for disk. Just click on LOAD, position your tape and press <Play> 
on your Datasette as requested on-screen 
say "Searching.-.", when a file is found 






The message disp 
the message will 



"FOUND 



< SAMPLE/SYNTH. /MELODY > 



<f i lename>" 



RAP4 data, the "FOUND" will be replaced 



stop and two extra buttons will 
w i s h t o 1 o a d 



t h i s ■('■ i .1. e , 
click on NO. 



c: 1 i c k o n 



appear 
YES and 



If the file 



you don't, 

on the QUIT button. 



by "LOAD? 1 
marked 



the 



layed will 
c h a n g e t o 

is genuine 
tape will 



YES 



and NO. If 



y o u 



the data will be loaded. If 



If you wish to abort the load process, click 



1 4*4 



t? 
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«4* ■- * ,- <*- i..- ,i i/. r . . ' 



^ff?V 



, . i ..j _—i- . *.? ■„ in*, "■ - "iS" ;* **£•,*; v. riw*:- . 4ri#^ „ .*- 'htftjlilv ■ r 



, -*» 



.*■ -, ■^■■■t *& 



- . ,r" * 



M- « 



£u .«■ ■ »* *: 



>J« i ^ ■**» *^*i 



_ *.- ■>!.?■:*" 



LEAVING RAP4 & RECOVERING FROM MISTAKES 



THE ABORT PROGRAM SCREEN 



W I" i e n y o u h a v e f i n i s h e d u s i n g R A P 4 
function from the SYSTEM menu to exit 



screen displays a warning 
r e t u r n t o t h e m a i n s c r e e n , 

p 

•f ] ^PX **•** /**% t" # *# *»*" 

sele c *c h & u k T » 



y o u c a n sele c: t t h e A B R T 

to' BASIC- The Abort Screen 

message and features just two buttons.. To 

click on QUIT, or to exit unto oblivion. 



RECOVERING FROM MISTAKES 



mean 



It is i ne v i t able t hat at some time while 
you will do something you didn't 
playing a £ull memory sample at a 
results in five minutes and three seco 



using the RAP4 Editor 9 

to do. Examples of this a.re 

playback speed of zero which 

ids of boredom, or trying to 



load § cassette file that 

recover from all these situations leaving your 

done in the following way:- 



doesn't exist:.- You can however easily 



data intact. This is 



While holding down the <RUN/STOP> key 






the right --hand side of your 
machi ne-code TEDMON monitor - 



PI us/ 4 

To 



HELP button 
RAP4 screen 



get back 
(right -most function key) , 
leaving all your sample datk etc 



push the Reset button on 
Thife as usual puts you into the 

into RAP4 3 simply press the 
5 returns vou to the 



Thi 



you 
unaffected 



main 



That ends the 



f i !•- s t part o f 



the manua I 



second section covers RAP4*s other component 



on the RAP4 Editor . The 
- RAP4 BASIC- 



-i- 



LxHHK ! t.K b 



INTRODUCING RAP4 BASIC 



So that you c&n 

RAP4 



created using the 
extension to the normal 



easily use 
Editor 



t he 



sounds and melodies you have 






package 

t h e 



in youu 
Plus/4 BASrC hcis 



■■■* I 



The system has been written in 
Lditor- 



close to 

experience 



t h e 



n e w c o m m m a 



j making t 
s p o k e n E n g 1 i s h „ s o e v m n 
of BASIC should ■find the comma 



own programs, 

been included in 



a special 
the RAP4 



accordance with the design 



n d s 



very easy to 

someone who has 
rids simple to 



LOADING RAP4 BASIC 



RAP4 BASIC 



is 



loaded in an identical 



wa 



<SHIFT>~<RUN/STOP> to load the RAP4 menu then push key 
option will flash and BASIC will 



load 



copyright message on 
prompt. At .this point,, 
use of these commands 



t h e 



verv 



3' * 

u e 1 1 j g 

«|* «W *♦* ■■* •** >*** 



i—i *w -.*« j i 



v to the RAP4 Editor 



F#4fi 



Push 






The 



1 K 



menu 

, ui^ H .!.cvyxiiy a start up> 

screen, 

there are five (new commands available 
explained here 



displaying 
foil tawed by the usual READY 



PUNCTUATING RAP4 COMMANDS 



All of 

Commodore 
a Command 
be low s ™ 



RAP4's commands take a stan 
BASIC. The format of each comm 
Template., The template for t 



The 



ard 




is 



yntax 

shown 



like that of 
in the form of 



DAB ESAMPLE/SYNTH/MEL0DY3 "<FILE~NAME: 



The notation 



tht 






't 



C L U St J, 



hor such a template 






3*5 



command 



Ar gument s wit h i n 



arguments that are obligators 



««.*.*» 



t h e y 



LOAD command is shown 



H 



(USING CTAPE/DI3K3) 



f o 1 1 ows s The f i r s t word is 



brackets 



"CD" are 



within parentheses " ( ) " arB volountary arguments 



to be 



entered 

the 

"SAMPLE. NAME". 






»** «* 



« ■■ > 



4- rn i- 



in angle brackets 

for example 



..j !•" ft j ? ,","( i".\ }", *f" 

Where there are a 



S 



u 



1 i m i t e d 



an argument,, these ariB separated using 
addition, there are two extra things 
commands- When you are enter inq a comma rid 



square oracR»w» 
must be entered. Arguments 

which do not have 
<>" should be replaced by 

■- F I LE NAME > " m i g ht become 

n u m b e r o f a 1 1 e r n a t i v e s f o r 
slash "/" characters* In 

r e m e m b e r a b o u t R A P 4 



to 



p £* r t o f 



not as 



i n d i r €* c t m o d e , 
a program,, or are using a command after a THEM* or : ELSE 
statement,, you must precede the command 
"LOAD" becomes "*LOAD M . 



Note also thai 



p. i\ r» t .,., 



+. 



"■ I*' -•**} f X ***+ '*•* **** "A* «H4 VM4 



*.i -j i Vi-.*< ■■■ •«■> t j v 

expression ""FILENAME"* can be replaced 

replaced by *W/ m > or : ' 200+34 >. Additional 

a s t h e s t a n d a r d L A D c o m m and :m s t i 1 1 

w 1 1 1 t e s t w h e t h e r the c o m m a n d i s 



I 9 W Vl4i \*+\ 



***** /*. i* 4 -, /t 
'-«. t ** i II 3 



i 
• f * 






4 LP* 

ill 



•, .-! 



by 



a 



COLON 



for example 



y be replaced by any valid 
by "Hf or '234' 

'I w 



a^^ %«.* i 



can be 
standard commands such 



'*•* »<■» ^**1 4 '4 ***4 



^ ! H A ! n : ' ' ^ r n n i ••• m m * ' o •« 

-' r • % ••• j-' 1 Uy I v;:l(ll >| u.< ■, j. 



r*n "! 1 

V *« J U» .4. >U 



normal. RAP 4 BASIC 
3 1 e m e n t a t i o n a r a 3 1 a n d a r d 



command, and will re-route the command to the appropriate code.. Thus 

j, ■ "i^4 f A Ci t* A PI 1*1 «.^ I*- "i r M ; «-- r-\.r-f i-» *i m r i Hra 1^* r s \ •••< ■■*•• :i I fl/* 1 - r% 
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1 t 
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IV 



THE RAP4 BASIC COMMANDS 



THE LOAD COMMAND 



LOAD CSAMPLE/SYNTH/MELODY3 "<f i lename>" ( 



USING CTAPE/DISK3) 



The template for the LOAD command is shown above- The LOAD command 
forms the heart of RAP4 BASIC and is used for importing data saved 
from within the RAP4 Editor. The command is used "for loading 



s a mp 1 e s , s y n t hs&ize r / d r u m k i t 
By default , 



setups or 
the command uses disk for loa 



i 



by adding a "USING TAPE/DISK" argument. 

LOAD from tape or disk, all subsequent LOftDs will use 

device. 



Examples: 



2 LOAD SAMPLE "sound" FROM DISI- 



Loads a 
disk 



LOAD MELODY "melody" 



Loads a 
device 



Tape & Disk Loading Procedure 



When loading data from tape, 
message "Press play on tape" is displayed 
button on your Datasette., the message " 

a file is found 



melodies from tape or disk,, 

ding, but you can set this 
Note that after the first 



the last used 



sample called "sound" from 



melody from the last used 



W h e n 

< Sample/Synth/ Me lod 



y 



o 



on the 
•" FileName* " i 

one you specified, the message "Loading 
data is loaded- If the file is 

specified, the 



the procedure is as follows: The 

When you push 
Searching., , „ " is displayed,. 

the messaae "Found 




t h e < P 1 a y > 



pa 



layed 



message 

If the file is the 



tt 



• h 



not 



p r a c e s s r e p e a t s u n t i I t h e r 



W h e n 1 o a d i n g d a t a 



* . * «. 



and 



'9 Jk,* 



you spec xty, 

the data is loaded,. 

standard DS and DS* 



t- r o m d i s k , t h e d r i v e 

f a u. n d „ 



is displayed and the 

you 



the same as the one 

i g ht f i 1 e is f on n d ■ 






searched 



the message "Loading 
If a disk error occurs, it 
v a r i a b 1 e s » To f i n d t h m e r r o r 



ii 



t-or the file 
is displayed and 
is indicated 



O a (J 



THE SOUND COMMAND 



SOUND SAMPLE 

• NOTE 

DRUM 
MF! nnv 

I * *«*. iw. '♦«.' .w 4 



< s a m p I e n u m b e r 
<key letter >" 

* } :f {.;' m \/ | o f- f* as V- ":• r ! 

■• r». W ;/ ,|. w W '.♦* w i 



1* 



f I* 






ii 



i n t h e 
use 'PRINT DS$ ? . 



(USING SPEED vspeed 0-255 » 
( US I NG SAMPLE < samp I e number 



! I / 



(USING SAMPLE < sample number 0-7 >) 



The SOUND command 
elements 



■T /*H 

,1. '" 



1 1 c: m H H r> n 1 ;»* v ^ I ' 



s a m p 1 e m ., s y n t h emizer n o t e s , 
Three different syntaxes are available, 
W h e n p 1 a y i n g n o t e s o r m e 1 o d i e s 



c 



of RAP 4* 3 different sound 



r u m k i t 



drums or melodies 
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1 <? 



one -hor each type of sound, 
t he s a m p I e n u m b e r 






n o t 
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Sample numbers are in the range 0-7 and p 
0-255, as in the RAP4 Editor,, 



Examples: 



sSOUND SAMPLE 0, USING SPEED 200 *• Play sample at speed 200 



: SOUND MELODY ON SAMPLE 2 



IHlt 



Play 



he 



r 



10 SOUND NOTE "R" ON SAMPLE 



...J 



100 SOUND DRUM "T" 



t 

sample- 
Play t 
sample 
Play drbffl "T 



lay back speeds in 



t h e r a n g e 



c u r r e n t rn e 1 a d y u s i n q 



he note on key 






1*4 



J 



If 



THE DEFAULT SAMPLE COMMAND 



DEFAULT SAMPLE < sample number > 



The DEFAULT command 



is 



used to set up 



used for playing synthesizer notes o 
command wheta it is not explicitly stated 



Examples 



10 DEFAULT SAMPLE 7 
20 SOUND MELODY 



w h i c h w i 1 1 ta e 
melodies with the SOUND 



the sample 



r 

in the SOUND command. 



;-■» 



Play current melody using default sample 7 



s DEFAULT SAMPLE M> 



Set up default sample as the number in N% 



THE LIST INFO COMMAND 



LIST INFO (USING C SCREEN/PR I NTER II ) 



The LIST command is used to display som£ useful information about 
the current set of samples etc. which h 



ave been loaded into memory 
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in vour 
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